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PREFACE 



This manual provides the programmers and operators of Series 16 computer systems 
with the information necessary to use the following Honeywell-supplied source language 

processors: 

016-XREF Cross-Reference Listing 

SSUP Symbolic Source Update 

MAC Macro Instruction Processor 

Elements of the languages, examples of their use, exception conditions, and related 
supporting programs are described. Instructions for generating stand-alone systems and 
instructions for executing the programs are also included. 

The reader is assumed to have a basic familiarity with Series 16 assembly language 
programming and to have read the 316/516 Programmers' Reference Manual , Order Number 
BX47 (formerly M-490). 

The illustration on page v provides an overview of the relationship among the three pro- 
cessors and other elements of the assembly language system. 
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SECTION I 
MAC MACRO PROCESSOR FOR DAP- 16 



The Macro Processor (MAC) is a single-pass processor used to expand DAP-16 
Assembly Language sources containing prototype macro definitions and statements. Macro 
definitions can be entered from a separate library or they can be embedded in a single 
source. The definitions are retained in main memory for the duration of the job. As the 
macro prototypes are expanded according to a macro statement, the actual arguments of 
the macro statement replace the dummy arguments of the macro definition. The MAC out- 
put is assembly source code which is suitable for input to the DAP-16 Mod 2 Assembler. 

GENERAL DESCRIPTION 

T'he macro language provides a convenient way to generate a desired sequence of 
assembly language statements many times in one or more programs. The macro definition 
which defines the desired sequence of statements is written once near the top of the pro- 
gram. Then, a single statement, the macro statement, is written each time the desired 
code is to be generated. This simplifies program coding, reduces the chance of program- 
ming error, and ensures that standard sequences of statements are used to accomplish de- 
sired functions. 

Conditional assembly can also be used with the MAC processor. In this way, state- 
ments can be coded which may or may not be assembled, depending upon conditions evalu- 
ated at assembly time. These conditions are usually tests of values, which can be defined, 
set, or changed during a macro expansion. 

Macro Definition 

Every macro definition is divided into three major components: the header (or first) 
statement, the body of the macro which specifies the prototype, and the end (or last) 
statement. 

HEADER STATEMENT 

The first record of every macro definition must conform to the following: 
Macro Name MAC(*) (list of arguments used) (comments) 



Field 1 Field 2 Field 3 - Optional 

{*) - Optional 
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Field 



Columns 
1 through 4 

6 through 8 

9 



12 through 72 



Contents 

Macro name, maximum of four char- 
acters (cannot have * or $ as first 
character). 

The letters MAC. 

An asterisk if the macro expansion 
is to be preceded by two comment 
records. A space if the comment 
records are to be omitted. 

An optional argument list, comments, 
and/or identification statements which 
are ignored by the processor. 



MACRO DEFINITION BODY 

The body of the macro definition (DAP-16 format assumed) consists of prototype 
code containing dummy variables. The dummy variables are replaced by the arguments 
passed in the macro statement when the statement is expanded. The expanded source code 
is output in the same relative position from which the macro instruction statement was 
read. Comment lines within the definition will be output unchanged when the macro proto- 
type is expanded. Any occurrence of the character pair #0 will be replaced by a single 
digit between one and nine which represents the number of actual arguments in the macro 
statement (call). This digit can be less than, equal to, or greater than the number of 
dummy arguments, but in no case can it exceed nine. 

Any occurrence of the character pairs #1 through #9 will be replaced by a copy of 
the corresponding actual argument when the macro is expanded. This point is illustrated 
in the examples which follow. 

Macro statements referencing previously defined macros are allowed in the body of 
a macro definition. Macro names included in the argument list require additional passes 
to complete expansion (i.e., the MAC processor is not re-entrant). Likewise, recursive 
use requires an additional number of passes equal to the degree of recursiveness. 



END STATEMENT 

The last record of every macro definition must contain the following 
( ) ENDM ( 



Field 1 



Field 2 



Field 3 
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Field 

1 
2 
3 



Columns 
1 through 5 
6 through 9 
10 through 120 



Contents 

Ignored. 

The letters ENDM. 

Ignored. 



Macro Stat ement 

A macro statement can call a macro any number of times after the macro has been 
defined by the macro definition. Each macro statement must contain the following: 

(label]. Macro Name (arg 1, arg 2. . . . arg 9) (comments) 



Field 1 



Field 2 



Field 3 



Field 



Columns 
1 through 4 

5 
6 through 9 
10 and 11 
12 through 7 2 



73 through 120 



Contents 

Label or blank. 

Ignored . 

Name of macro being called. 

Ignored. 

The argument list terminated by one 
or more blanks. Each argument 
may consist of any number of char- 
acters. Any character may be used 
except a comma or a blank. A pound 
sign (#, '243) is converted into a 
blank during the expansion. Argu- 
ments are separated by commas. 
Null arguments are acceptable. 

Ignored. 



Data Format 

Source data for MAC is prepared in a manner similar to the source data for DAP-16. 
If the standard input routines are used, tabs will be set at columns 6, 12, 30, and 73. The 
backslash character can be used to compress the source tape. If MAC output is punched 
on paper tape using the standard output routines, backslash characters are used to tab to 
columns 6, 12, 30, and 73. 

End-of-text records (ETX, '003 or '203 on the ASR or high-speed reader, or 11-8-6 
for cards) are ignored on input and are not generated on output. 



Input will be halted during a job upon detection of a MOR pseudo -operation. This 
feature allows the concatenation of macro libraries and other sources. It also allows the 
changing of input device selection. 
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One file per job is processed by the MAC processor. If the source is entered from 
paper tape or cards, the file must be terminated by a record containing a dollar sign ($, 
'044 or '244) in column 1. The letters END may follow in columns 2 through 4. On mag- 
netic tape, files may also be terminated by a tape mark. 

Magnetic tape input allows records of up to 120 characters. This facilitates the 
processing of source material with the Honeywell Series 16 FORTRAN system, which 
writes 1 20-character formatted records. 

Magnetic tape output is written in 1 20-character records. Thus, subsequent language 
processors must accept this record length. 

Errors 

MAC recognizes five error conditions. For each of these, a message is printed on 

the teletypewriter in the following form: 

* (error flag) record being processed 



The error flags are listed in Table 1-1. 



E rror Flag 



A 



M 



O 



Table 1-1. MAC Error Messages 



Description 



More than nine arguments in the actual argument list. 
The request for the number of arguments (#0) is not 
counted. 

Field overflow in macro expansion. An attempt has been 
made to store a character other than a space in or beyond 
columns 5, 11, 29, or 72. MAC ignores this error. 

MAC pseudo-operation in macro definition. This record 
is ignored. 

Memory overflow. There is insufficient space in the free 
core area to store all macro definitions. This error ends 
the job. 

Formal argument not #0 through #9. A # which is not fol- 
lowed by a single decimal digit has been detected within a 
macro body. This error is not detected until the macro 
is expanded. MAC goes to the next field of the current 
record of the macro body. 



SYSTEM GENERATION 

The generation of a MAC system is done in a straightforward fashion. The relocatable 
object of MAC is loaded, usually at the default starting address of '1000. It will call the 
relocatable input/output supervisor, MAC-IOS, which in turn will call the off-line I/O 
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driver programs. The drivers for the desired devices, including the magnetic tape sup- 
port package, may be loaded in any order. Finally the calls for unwanted devices must be 
satisfied with G$DR, which will also pass to MAC-IOS the bounds of available memory. 

If G$DR is loaded in the extended desectorizing mode (EXD), MAC will be entered 
in the extended mode (EXA) and memory through 32K will be used. If G$DR is loaded in 
the normal desectorizing mode (LXD), MAC will be entered in the normal mode (DXA) and 
memory through 16K will be used regardless of the presence of additional memory. 

The keyword is loaded at G$DR, which may be located by obtaining a core map. As 
loaded, the keyword contains '000022, which selects paper tape input (with parity) and 
output. The keyword default value may be changed at this time. 

OPERATION (Keyword) 

Prior to starting MAC, the source to be expanded, which must have all macro proto- 
types physically before they are required, must be ready, as must the output device. Set 
the keyword in the A register if other than the default value is used and start at the first 
address of MAC, normally '1000. 

The source will be read until either a MOR pseudo -operation is encountered or a 
MAC end-of-file is detected. The latter must be either a dollar sign in column 1 or a tape 
mark. Any ETX records on paper tape or cards are ignored. The MOR pseudo-operation 
will cause the message MORE to be typed and the processor will stop for operator action. 
The keyword, which may be changed before restart, will be displayed in the A register. , 

Output may be generated immediately depending upon the input data. If paper tape 
is being used, MAC will punch leader and trailer. 

The A register must be set with the keyword at' the start of the program. If the word 
is zero, the default word ('000022 unless changed at system generation) will be used. If 
any bit is set, the A register must contain the entire desired keyword. The A register 
setting for the keyword is shown on the following page. 
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ntrol 1 



Process Co 

- Normal output 

1 - Errors only output 



11 12 13 14 15 16 



Source Device • 



1 - ASR 

2 - Paper tape reader 

(even parity) 

3 - Card reader 

4 - Paper tape reader 

(no parity) 

5 - Magnetic tape logical 

6 - Magnetic tape logical 1 

7 - Magnetic tape logical 2 



Output Device 

- No output 

1 - ASR 

2 - Paper tape punch 

3 - Card punch 

4 - Line printer 

5 - Magnetic tape logical 

6 - Magnetic tape logical 1 

7 - Magnetic tape logical 2 



MESSAGES 

The only non-error run message is MORE, which indicates that a MOR pseudo- 
operation was encountered. 

A MAC error message may be typed as indicated in "Errors" above. Other error 
messages are: 

DEVICE NOT AVAILABLE 

RECORD UNREADABLE (magnetic tape only) 

END OF TAPE (input or output, magnetic tape only) 

The end of job is indicated by: 

** MACRO ERRORS 
or NO MACRO ERRORS 

PAPER TAPE PARITY 

MAC includes support of paper tape punched with even parity. Honeywell does not 
supply Teletypes equipped to punch parity in the United States, but the option is common 
elsewhere. An error is processed within the driver program and the appropriate docu- 
mentation must be consulted for advice. All output on the paper tape punch is made with 
level 8 marking (i.e., punched). 

TERMINATION 

At the end of the job, magnetic tape input is positioned after the tape mark or the 
dollar sign record. An output tape will have a tape mark but not an $END record. The 
output tape is left just beyond the tape mark. 
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Other output devices will be terminated with a record containing $END columns 1 
through 4. 

The A register will contain the keyword. A new job may be started from the halting 
location. 

INTERNAL MAC EXPANSION PROCESSING 

The input stream is scanned for macro instruction statements one record at a time. 
Upon detecting a macro instruction statement, two comment records are output, if the 
prototype indicates the selection (an asterisk in column 9 of the first prototype statement). 
The first optional comment record contains an asterisk in column 1, followed by blanks. 
The second contains an asterisk in column 1, blanks in columns 2 through 4, and a copy of 
the macro statement in column 5 through 120. 

Following the comment records, the prototype is expanded. Each record of the 
macro prototype is examined and comment records within the macro definition are output 
unchanged. Other records are expanded field by field (i.e., columns 1 through 5, 6 through 
11, 12 through 29, and 30 through 72). Any occurrence of the character pair #0 is replaced 
by a single digit between 1 and 9 that represents the number of actual arguments found in 
the input record. The character pairs #1 through #9 are replaced by their respective ac- 
tual arguments listed in the macro statement (i. e. , #1 is replaced by the first actual argu- 
ment, #2 is replaced by the second actual argument, etc. ). If the actual argument does 
not exist, the whole record is ignored and MAC goes to the next record of the macro pro- 
totype. All pound signs in the arguments are converted to spaces in the output record, 
except in the two optional comment records preceding a macro expansion. 

Any noncomment records which have an operation field (columns 6 through 9) pre- 
viously defined by a stored macro definition are expanded. All other records are copied 
unchanged. 

MEMORY REQUIREMENTS 



The macro prototypes are packed into core. The MAC and ENDM records require 
a total of seven half-words. For other records in the macro prototypes, one half-word is 
required for each nonspace character, one-half word is required for each sequence of 
spaces not at the end of a record, and one-half word additional is required for each record. 

MACRO EXAMPLES 

Five examples of macro applications are presented in this section. If the MAC output 
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is punched on paper tape, it contains backslash characters to represent tab to columns 6, 
12, 30, and 73. The MAC output listings in this manual have been expanded to the correct 
tab position for each of reading. 

Generation of Calling Sequences Using Subroutines 

If a subroutine is called many times during a long program, a macro definition of 
the calling sequence can be written. A typical macro definition for a call to subroutine 
YORN is: 

TEST FOR YES OR NO 

YES OR NO ROUTINE 

NO 

YES 

INVALID CHARACTER 

END OF MAC YORN 

After the macro has been defined, a macro statement which references the macro 
definition can be inserted at any point in the coding: 



YORN U,V5 TEST ANSWER 5 



YORN MAC* 


#1 ,#2 


JST 


YORN 


JMP 


#1 


JMP 


#2 


* 




ENDM 




MOR 





MAC expands the prototype which generates the coding shown below. The first two 
lines are the optional comment lines, which have been generated because the first state- 
ment of the macro definition contains an asterisk in column 9- 



* 






* 


YORN 


U,V5 




JST 


YORN 




JMP 


U 




JMP 


V5 


* 







TEST ANSWER 5 

YES OR NO ROUTINE 

NO 

YES 

INVALID CHARACTER 



Use of #0 in Macro Expansion 

Any occurrence of the character pair #0 will be replaced by a single digit between 
and 9 when the macro is expanded. The number which replaces the character pair #0 rep- 
resents the number of actual arguments passed from the macro statement. It can be less 
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than, equal to, or greater than the number of formal arguments but in no case can it 
exceed 9. 

In the following example, the prototype code for the previous example is modified by 
adding the character pair #0 in three places: 



Y0 


RN MAC* 


#1 ,#2,#0 




JST 


YORN 




JMP 


#1 




JMP 


#2 


* 


ENDM 
MOR 





TEST FOR YES OR NO 

YES OR NO ROUTINE 

N0,#0 

YES 

INVALID CHARACTER, #0 

END OF MAC YORN 



The same macro statement is used to cause the expansion shown belo\ 



YORN U,V5 

JST YORN 

JMP U 

JMP V5 



TEST ANSWER 5 

YES OR NO ROUTINE 

NO, 2 

YES 

INVALID CHARACTER, 



Note that the first occurrence of the character pair #0 was in the dummy argument 
list and does not appear in the expansion. The second occurrence of #0 is in a coding line 
and is replaced by 2, which is the number of actual arguments. The last occurrence of #0 
is in a comment line. In this case, the pound sign is taken as a space and the character 
is printed unchanged. 

Generation of Complete In-Line Coding 

This type of coding may be inefficient in terms of memory used, but it is simpler 
than calling a subroutine and runs faster. An example containing two macro definitions 
is presented in Figure 1-1. The macro definitions are placed at the beginning of the pro- 
gram. The macro statements which reference the macro definitions are placed within the 
body of the program as frequently as desired. 

MAC generates the coding presented in Figure 1-2 each time the prototypes are 
expanded. 
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FILL 


MAC* 


#1 ,#2, #3 




LDX 


:-#3 




LDA 


#2 




STA 


#]+#3, 1 




IRS 







JMP 


*-2 




EN DM 




COPY 


MAC* 


#1 ,#2, #3 




LDX 


= -#3 




LDA 


#1+#3,I 




STA 


#2+#3, 1 




IRS 







JMP 


*-3 




ENDM 





FROM ,WI YH ,t-.'JU\'T 

*3 wop rs 

FILL WITH #2 

STARTING WITH # 1 

TALLY INDEX 

REPEAT TO END OF BUFFER 

END OF MAC FILL 

FROM ,7 0, COUNT 

#3 WORDS 

COPY FROM #1 

TO #2 

TALLY INDEX 

REPEAT TO END OF PUFFERS 

END OF MAC COPY 



Macro Definitions 



COPY 
FILL 



IN, OUT, 36 
IN ,=A## ,60 



COPY TO OUTPUT BUFFER 
CLEAR INPUT BUF 'ER 



Macro In -Line Coding 



Figure 1-1. In-L,ine Coding Example — Source Input 



* 
* 


COPY 


IN, OUT, 36 


COPY TO OUTPUT PUFFER 




LDX 


= -36 


36 WORDS 




LDA 


IN+36,1 


COPY FROM IN 




STA 


OUT+36,1 


TO OUT 




IRS 





TALLY IN6EX 




JMP 


*-3 


REPEAT TO END OF PUFFERS 



* 






* 


FILL 


IN, = A## ,60 




LDX 


z-60 " 




LDA 


=A 




STA 


IN+60,1 




IRS 







JMP 


*-?. 



CLEAR INPUT BUFFER 

60 WORDS 

FILL WITH =A 

STARTING WITH IN 

TALLY INDEX 

REPEAT TO END OF BUFFER 



Figure 1-2. MAC Expansion of In-Line Coding 
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Using Macros to Implement Interpretive Sch e me 

In this example, a scheme is presented which will allow the coding of a process of 
several steps involving complex variables. The macro definitions used in this example 
are presented in Figure 1-3. 

With these macro definitions, it is possible to code the complex equation 
Y = A * SIN (A * Tl + B * T2) * COS (B * Tl-A *2) 
as the series of macro statements shown in Figure 1-4. 

The assembled output of MAC will be similar to the listing presented in Figure 1-5. 
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MAC 


1 




CALL 


LS55 




DAC 


#1 




ENDM 




+ 


MAC 


1 




CALL 


A$55 




DAC 


#1 




ENDM 




- 


MAC 


1 




CALL 


S$55 




DAC 


#1 




ENDM 




X* 


MAC 


#1 




CALL 


M$55 




DAC 


#1 




ENDM 




/ 


MAC 


#1 




CALL 


DS55 




DAC 


#1 




ENDM 




NEG 


MAC 






CALL 


N$55 




DAC 


#1 




ENDM 




z 


MAC 


1 




CALL 


HS55 




DAC 


#1 




ENDM 




SIN 


MAC 






z 


W 




CALL 


CSIN 




DAC 


W 




ENDM 




COS 


MAC 






z 


W 




CALL 


CCOS 




DAC 


W 




ENDM 




EXP 


MAC 






z 


W 




CALL 


CEXP 




DAC 


W 




ENDM 




LM 


MAC 






s 


w 




CALL 


CLOG 




DAC 


W 




ENDM 




SQRT »C 






z 


W 




CALL 


CSQRT 




DAC 


W 




ENDM 




ABS 


MAC 






r 


W 




CALL 


CABS 




DAC 


W 




ENDM 






MOR 





LOAD COMPLEX VARIABLE 

END OF MAC BLANK 

COMPLEX ADD 

END OF MAC + 

COMPLEX SUBTRACT 

END OF MAC - 

COMPLEX MULTIPLY 

END OF MAC X* 

COMPLEX DIVIDE 

END OF MAC / 

COMPLEX NEGATE 

END OF MAC "EG 

STORE COMPLEX VARIABLE 

END OF MAC = 

COMPLEX SINE 
END OF MAC SIN 

COMPLEX COSINE 
END OF MAC COS 

COMPLEX EXPONENTIAL 
END OF MAC EXP 

COMPLEX LOG 
END OF MAC LN 

COMPLEX SQUARE ROOT 
END OF MAC SQRT 

COMPLEX ABSOLUTE 
END OF MAC ABS 



Figure 1-3. Macro Definitions for Interpretive Scheme 
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■ 




A 


LOAD A 




X* 


Tl 


A*Tl 




; 


VH-4 


STORE A*T1 






B 


LOAD B 




X* 


T2 


B*T2 




+ 


tf+4 


A*T1+B*T2 




SIN 




SINE OF (A) 




X* 


A 


SINE OF (A)*A 




r 


V+A 


STORE SINE OF (A)*A 






A 


LOAD A 




X* 


T2 


A*T2 




z 


W+8 


STORE A*T2 






B 


LOAD B 




X* 


Tl 


B*T1 




- 


i#+S 


B*Tl-A*T2 




COS 




COSINE OF (A) 




X* 


W+4 


A*SIN*COS 




z 


Y 


STORE Y 


w 


BSZ 


8 




Y 


BSZ 
END 


4 




$ 









Figure 1-4. Macro Statements for Interpretive Scheme 
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0001 00000 10 00000 CALi LS55 

0002 00001 000067 DAC A 

0003 00002 10 00000 CALL M*55 

0004 OOOO3 000064 DAC Tl 

0005 00004 10 00000 CALL HS55 

0006 OOOO5 000054 DAC W*4 

0007 00006 10 00000 CALL L$55 

0008 00007 000065 DAC 8 

0009 00010 10 00000 CALI MS55 

0010 00011 000066 DAC T2 

0011 00012 10 00000 CALL At55 

0012 00013 OOOO54 DAC W*4 

0013 00014 10 00000 CALL H$55 

0014 00015 OOOO5O DAC W 

0015 00016 10 00000 CALL CSIN 

0016 00017 000050 DAC W 

0017 00020 10 00000 CALL MS55 

0018 00021 000067 DAC A 

0019 00022 10 00000 CALL HS55 

0020 00023 000054 DAC W*4 

0021 00024 10 00000 CALL L$55 

0022 00025 000067 DAC A 

0023 00026 10 00000 CALL M$55 

0024 00027 000066 DAC T2 

0025 00030 10 00000 CALL HS55 

0026 00031 000060 DAC W*8 

0027 00032 10 00000 CALL L555 

0028 00033 000065 DAC B 

0029 00034 10 O000O CALL M$55 

0030 00035 000064 DAC Tl 

0031 00036 10 00000 CALL SS55 

0032 00037 000060 DAC W*8 

0033 00040 10 00000 CALL H$55 

0034 00041 000050 DAC W 

0035 00042 10 00000 CALL CCOS 

0036 00043 000050 DAC W 

0037 00044 10 00000 CALL Mt55 

0038 00045 000054 DAC W*4 

0039 00046 10 00000 CALL HS55 

0040 00047 000060 DAC Y 

0041 00050 000000 H BSZ 8 

0042 00060 000000 Y BSZ 4 

0043 END 



LOAD COMPI FX VARl ABI E 
COMPLEX MULTIPLY 
STORE COMPLFX VARIABLE 
LOAD COMPLEX VARI ABI E 
COMPLEX MULTIPL* 
COMPLEX ADD 

STORE COMPLFX VARIARLF 
COMKLt* SINE 

complex multiply 
store complfx variablf 
load complex variable 
complex multiply 
s ore complfx variarlf 
lcao cohplex variable 
compLfx Multiply 
complex subtract 
store complfx vahiablf 
complex cosinf 
complfx multiply 
store complfx variablf 



Figure 1-5. Assembler Listing for Interpretive Scheme 
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Macros Used With Conditional Assembly 

Macro prototypes can be coded to include conditional assembly statements and the 
assembly process thereby directed by the value (or presence) of certain arguments. Coding 
using conditional pseudo -operations to call cither the ASK or line printer off-line driver 
program is shown in Figure 1-6. 



PRNT MAC* 


#1 ,#2 


TEST FOR OUTPUT DEVICE 


IFZ 


#1-4 


ZERO IF LINE PRINTER 


CALL 


OSLA 


CALL L.P. 


DAC 


#2 


BUFFER ADDRESS 


ENDC 




END OF L.P. CONDITIONAL 


IFZ 


#1-1 


ZERO IF ASR 


CALL 


0$LL 


CALL ASR 


DAC 


#2 


BUFFER ADDRESS 


ENDC 




END OF ASR CONDITIONAL 


IFN 


#1-1 


ASR TEST 


IFN 


#1-4 


L.P. TEST 


FAIL 




ERROR CONDITION 


ENDC 




END OF L.P. TEST 


ENDC 




END OF ASR TEST 


ENDM 




END OF MAC PRNT 


MOR 







Figure 1-6. Macro Definition Using Conditional Pseudo-Operations 



Following the macro definition, the line printer can be called using the following 
macro statement: 



PRNT 4, DATA 



1=ASR,4=LINE PRINTER 



When the MAC output is assembled, the program listing will contain the line printer 



call: 



» PPNT 4. DAT A 

C/U.l OSLA 
DAC DATA 



1 -k^R. A = L IMP 1 PR IMF" 
CAM I . d . 
PIIFFFR AnnRFS^ 



Conversely, to call the ASR: 



PRNT l.DATA 



1=ASR,4=LINE PRINTER 
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results in: 



P<?NT l.DATA 
CALL n T LL 
DAC DATA 



1=ASR,4=LINF PRINT^P 
CA|_I ASP 
8IIFTFW ADnRCS^ 



If neither 1 nor 4 is passed as an argument, the FAIL pseudo-operation will be 
assembled and an error flagged: 



PRNT 3 . M D I) T 
FAIL 



l=A c ;R,4 = l. INF PR I NT F" 
FDROR C N n I T I n N 



Trace Example Using Macros and Conditional Assembly 

In this example, a macro definition to call FORTRAN IV Trace Program F$TR from 
an assembly language program is shown. Conditional assembly pseudo -operations are 
used to distinguish between a statement number (label) trace and other traces, and the call 
is adjusted accordingly. The macro definition used in this examp e is shown as Figure 1-7. 



0= TRACE STATEMENT NO. 



TR MAC TYPE, NAME 

IFZ #1 

CALL F$TR 

VFD 3, #1,5, '37, 8, "240 '37=HALF<, '240 PREVENTS AT SIGN 

BCI 2, #2 
ELSE 

IMA #2 

CALL F$TR 

VFD 3,#1 

BCI 2, #2 

IMA #2 
ENDC 
ENDM 
MOR 



Figure 1-7. Macro Definition for Conditional Trace Example 

In the example, it was decided to trace the logical variable FLAG, the interger 
variable A, and the label TWO. F$TR requires the argument #1 to be 3, 1, and 0, respec- 
tively, to identify these types of variables. The macro statement TR and the variable type 
and name arguments were then inserted into the existing code at the points where tracing 
was desired. The results are shown in Figure 1-8. 
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* 


CF5 
REL 
CRA 


TRACE EXAMPLE USING MACROS 




LOOP 


STA 


FLAG 






TR 


3, FLAG 






SLZ 








JMP 


TWO 






STA 


A 






LOA 


= -4 






STA 


CNT 




FST 


IRS 


A 






TR 


l.A 






IRS 


CNT 






JMP 


FST 






LDA 


FLAG 






ERA 


= 1 






JMP 


LOOP 




TWO 


CRA 








TR 


0,TWO 






STA 


A 






LDA 


:-2 






STA 


CNT 




SEC 


IRS 


A 






TR 


l.A 






IRS 


CNT 






JMP 


SEC 






HLT 






FLAG 


BSZ 


1 




CNT 


BSZ 


1 




A 


BSZ 
END 


1 




S 







Each macro statement within the coding is expanded and the actual arguments are 
substituted in the MAC output coding. A portion of this coding is presented in Figure 1-9. 

When the MAC output is assembled, the conditional pseudo-operations cause the 
inappropriate lines to be ignored. The assembly listing is presented in Figure 1-10. 

Following the assembly, the program was loaded and executed. The trace shown 
below was printed on the Teletype. The @ signs result from some assumptions within 
F$TR relative to the (normally) compiler -generated call. 

■*FL4 6= F 

8A= 1 

9A = 2 

0A= 3 

94 = 4 

3FLQG- T 

(TWO) 

94 = 1 

9A^ 2 
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* TRACE EXAMPLE USING MACROS 

CF5 

REL 

CRA 

LOOP STA FLAG 

IF Z 3 OrTRACF. STATEMENT NO. 

PA 1 I F"$ TR 

VFD 3, 3, 5, '37, 8, '240 ' 37 ;HALF< , * 240 PREVENTS AT SIGN 

BCI 2, FLAG 
ELSE 

IMA FLAG 

CALL F$TR 

VFD 3,3 

BCI 2, FLAG 

IMA FLAG 
ENDC 
SLZ 

JMP TWO 

STA A 

LDA' = -4 

STA CNT 

reT IRS A 

!FZ 1 OrTRACE STATEMENT NO. 

CALL F$TR 

VFD 3,1 ,5, '37,8, '240 *37 = HALF< , '240 FRLVENTS AT SIGN 

BCI 2, A 

ELSE 

IMA A 

CALL F$TR 

VFD 3,1 

BCI 2, A 

IMA A 

ENDC 

IRS CNT 

JMP FST 

LDA FLAG 

ERA =1 

JMP LOOP 

TWO CRA 

IFZ o OrTRACE STATEMENT NO. 

VFD L 3,0^5, '37, g, '240 '37: HALF<, '240 P VVE'iTS AT S IGN 

BCI 2, TWO 

ELSE 

IMA TWO 

CALL F$TR 

VFD 3,0 

BCI 2, TWO 

IMA TWO 

ENDC 

STA A 

LDA =-2 

STA CNT 

SEC Jpz f 0--TRACE STATF -""-'- - 

CALL F$TR 

VFD 3, 1,5, '37. * 

pp T O » 



Figure 1-9. Typical MAC Output Code -Conditional Trace Example 
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0001 • TRACE EXAMPI E USING MACROS 

0002 

0003 

0004 00000 140040 

0005 00001 04 00053 LOOP 

0011 00002 13 00053 

0012 00003 10 00000 

0013 00004 060000 

0014 00005 143314 
00006 140707 

0015 00007 13 00053 

0017 00010 100100 

0018 00011 01 00031 

0019 00012 04 00055 

0020 00013 02 00060 

0021 00014 04 00054 

0022 00015 12 00055 FST 

0028 00016 13 00055 

0029 00017 10 00000 

0030 00020 020000 

0031 00021 140640 
00022 120240 

0032 00023 13 00055 

0034 00024 12 00054 

0035 00025 01 00015 

0036 00026 02 00053 

0037 00027 05 00057 

0038 00030 01 00001 
3039 00031 140040 T^O 

0041 00032 10 00000 

0042 00033 "- " 

0043 OH"- 

Figure 1-10. Typical Assembly Listing — Conditional Trace Example 



CF5 




RFL 




CRA 




STA 


flag 


IMA 


FLAG 


CALL 


FSTr 


VFD 


3.3 


BCI 


2. FLAG 


IMA 


Flag 


SLZ 




JMp 


two 


STA 


A 


LDA 


= -4 


STA 


CNT 


IRS 


A 


IMA 


A 


CALL 


F-& T R 


VFD 


3.1 


BCI 


2. A 


IMA 


A 


JRS 


CNT 


JMp 


FST 


LDA 


FLAG 


ERA 


= 1 


JMP 


LOOP 


CRA 




CALL 


FtTR 


VFD 


1 » 
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SECTION II 
016-XREF CONCORDANCE 



GENERAL DESCRIPTION 

The 016-XREF Concordance program prepares a cross-reference listing (concor- 
dance) of all symbols within a Honeywell DAP- 16 Assembly Language source program. 
The symbols are listed in alphanumeric order with the defining line numbers shown to the 
left (along with any exception flags) and the line numbers of all references to the symbol 
on the right. The line (record) numbers on the left are the same as the numbers shown 
on the left of a source listing or an assembly listing. Figure 2-1 shows an assembly 
listing of a source and the corresponding cross-reference. The source was written to 
show the features of 016-XREF. 

Symbol recognition is less restrictive than the similar process in the assemblers 
for the same language. Symbols which are almost acceptable are detected and the pro- 
grammer is made aware of them. 

The four exception flags are: 
M — Illegal multiple definition of symbol 
N — Symbol defined but never referenced 
S — Legal multiple definition of symbol 
U — Undefined symbol 

Flags M and U indicate lines of a finished program which are usually clearly in 
error. The N flag indicates a symbol which is not required by the assembler and may 
point out a programmer oversight. An acceptable multiple definition is indicated by an 
S flag. 

Each reference to a symbol can have a C or J suffix to the line number to indicate 
a change or jump, respectively. The C indicates that the referenced instruction is a STA, 
DST, STX, IMA, or IRS. A J results from a IMP or JST instruction. It should be noted 
that the C and J suffixes are useful only when the nature of the code is known, since the 
actual instruction and referenced address are subject to indexing, indirect addressing, 
program self-modification, etc. 
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0001 
0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
0010 
0011 
0012 
0013 
0014 
0015 
0016 
0017 
0018 
0019 
0020 



ooono 

00001 
00002 

00003 
00004 
00005 
00006 

00007 
00010 
00011 
00012 

00015 
00016 
00017 



L 



RETA 
UNO 



0021 

0022 00020 

0023 00021 
0024 

0025 

0026 00022 

0027 

0028 

0029 00023 

00024 
00025 



02 00000 
04 00000 
01 00000 



000022 
000000 
000007 

000020 



JKL 



XREF EXAMPLE 



ABC 



02 00016 
02 00016 
02 00016 
13 00017 

000016 
04 00007 
02 00007 



REL 


ABCD 


EXT 


BCD 


LDA 


BCD 


STA 


BCD 


JMp 


BCD 


LDA 


= 16 


LDA 


= '20 


LDA 


= $10 


IMA 


*AXY 



JKL 



JKL 



000000 

04 00024 

000020 

154331 



02 00023 

10 00023 PQR 



DAC 
STA 
LDA 
BSZ 

STA 
FIN 



LDA 
JST 



RETA SFT 
183 XAC 
RETA SET 

END 



000007 



= 16 
JKL 
JKL 
3 

MNO 
UNO 



= 16 

= 16 



OSLA 

JKL+ABC S Fl 

JKL THIS IS A COMMENT 



NO SYMBOLS NORMALLY HFRF 
EXTERNAl DEFINITION 
NO SUFFIX 
C SUFFIX 
J SUFFIX 


THREE LITFRALS WHICH HAVE 
THE SAMF LITERAL VAIUF. BUT 
A DIFFERENT SYMBOl IC VALUF 
C SUFFIX FOR A LITERAI 


ONE M Fl AG 
TWO NORMAL 


FROM JKL 
REFERENCES 


BOTH M AND 


N FLAGS FROM JKL 


u Flag on i 

NO SYM80LS 


1NO 
NORMALLY HFRF 


NO POOLING 
POR GETS N 


SHOWN 
FLAG 


S Fl AG ON 
II LEGAL SY 


RFTA 
1ROI 



BCD 00O000E 

RETA 000024 

0009 WARNING OR ERROR FLAGS 

DAP-16 MOD 2 REV. B 10-20-70 



MNO 



000025 



POR 



080021 



> 
O 



Figure 2-1. XREF Example (Sheet 1 of 2) 



XREF EXAMPI E 



N 


26 


1R3 




3 


ARC 


U 




ARCH 

BCD 


M 


14 


JKl 


NM 


17 


JKL 


u 




MNO 
0*LA 


N 


2 3 


PoR 


Ns 


25 


RFTA 


ns 


27 


RFTA 
= *10 
= t20 
= 16 
= AXY 




15 


SYMROl s 




20 


RfffRs 




29 


RfcoRds 




2 


U FtAfiS 




2 


M FLAGS 




5 


N FLAfiS 



27 

3 

4 
15C 

19C 
26 



1 1 

10 

9 

12 



5 

16 

20 



6C 
27 



7J 
29 



14 



22 



71 



016-XREF 05 OCT 70 



> 

o 



Figure 2-1 (cont). XREF Example (Sheet 2 of 2) 



Literals are treated as self-defining symbols rather than being evaluated. There- 
fore, the terms ='20 and =16, which the assembler may evaluate, are listed separately. 
The FIN pseudo-operation used to pool the literals is ignored. 

SYSTEM GENERATION 

The generation of an XREF system is performed in a straightforward fashion. The 
ORGed object of 016-XREF is loaded and this calls for the off-line I/O driver programs 
directly, with the exception of the Disk/Drum Operating Program (DOP) and its driver. 
Drivers for the desired devices, including the magnetic tape support programs, can be 
loaded in any order. Calls for unwanted device drivers can be satisfied with DUMY-X16. 

If the Honeywell- supplied magnetic tape support package is used, the channel type 
and number (if DMC or DMA is to be used) must be entered. The 016-XREF program 
uses logical unit 1 for input (same as the assembler) and this may also require an entry. 
Complete information is contained in the appropriate option Programmers' Reference 
Manual. 

When DOP is used, the linkages can be placed in sector zero either by directly 
entering them or by starting DOP. 

The load map should be examined for a high greater than '5000. If this is the case, 
the contents of location GRMA ('464 in Rev. B) must be changed to the next higher address 
ending in octal zero. This address indicates the lowest memory usable for storing cross- 
reference data. Conversely, if the high address is much below '5000, the contents of 
GRMA can be changed to a lower address. 

Locations '1000 and '1001 contain NOPs. The second location can be used for a 
LDA SYSP with the installation preferred keyword placed in SYSP ('506 in Rev. B) if 
desired. 

OPERATION (Keyword) 

The source to be cross-referenced must be made ready on the input device prior to 
starting 016-XREF. If magnetic tape is the input device (logical unit 1), it must be at the 
first record of the desired file. The input process is normally terminated upon detection 
of either an END pseudo-operation record or an end-of-file mark. If the input was from 
magnetic tape, the tape will be rewound at this time. 
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The installation-preferred keyword must be set into the A register prior to the start. 
Figure Z-Z is presented as a guide to keyword selection, if any Held is left blank, the 
indicated default value for that field is assumed. 



1 2 



Top of Available- 
Memory 

01 = 4K 

02 = 8K (Default) 



3 4 



8 9 10 



14 15 16 



-Listing Device 
1 = ASR (Default 
3 = Line Printer 
5 = DOP 



07 - 28K 
10 = 32K 



Source Device- 

1 = ASR 

2 - Paper Tape Reader (Default) 

3 = Card Reader 

4 = Magnetic Tape 

5 = DOP 



Figure 2-2. Setting of A Register for Keyword 

Start the program at (P) = '1000. If the keyword is not acceptable, the message 
PARM ERROR is printed on the ASR and the processor halts with the keyword in the A 
register. The keyword must be changed and the processor restarted from either the halt 
address or location '1000. 

At the end of the process, the processor halts and displays the keyword in the A 
register. Another concordance can be generated using the same or a different keyword. 
The concordance is listed as soon as a single input pass is complete. 

MEMORY REQUIREMENTS AND OVERFLOW 



On the average, a symbol is defined every five lines of code and each symbol is used 
five times. Each symbol requires eight words and a reference requires two words. Based 
on a GRMA of '5000, the source programs of various size listed in Table 2-1 can usually 
be cross-referenced in one operation. 

If the available memory is filled before the input is complete, the cross-reference 
to that point is listed with flags suppressed. After the operation is complete, the message 
SEGMENT BOUNDARY and the cumulative counts are printed. Then, in effect, a program 
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restart is made which picks up the source input at the point where it left off. The final 
section is terminated with the message FLAGS OMITTED. 



Table 2-1. XREF Memory vs Program Size 



Memory 



4K 
8K 
12K 
16K 
20K 
24K 
28K 
32K 



Records 



420 
1560 
2700 
3800 
5000 
6100 
7200 
8400 



J 



TERMINATION 

The concordance is terminated with the record, symbol, and reference counts along 
with the count of M, N, and U flags. If a segmented concordance ,«s generated, the 
cumulative counts of records, symbols, and references are listed tlong with the message 
FLAG OMITTED. 

MISCELLANEOUS CONSIDERATIONS 

The first record encountered is taken as the title line for all pages. It is also 
processed as a normal record. The presence of either unexpanded macro instructions or 
conditional assembly statements can produce warning flags which must be mterpreted by 
the programmer. 

External names are not indicated as such, but in general they may be noted by a 
blank-defining record field. The use of code such as 

A$BC XAC A$BC 
will obscure the external indication. References to multiply defined symbols are taken as 
referring to the first definition encountered. Subsequent definitions are listed, but they 
receive an N flag as well as an M flag. 
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SECTION III 
SSUP SYMBOLIC SOURCE UPDATE 



DESCRIPTION 

SSUP and its associated Input/Output Supervisor, SSUP-IOS, form a file maintenance 
system for Honeywell DAP- 16 Assembly Language and FORTRAN source files. Figure 
3-1 presents an overview of program flow. The old master or starting source is pro- 
cessed against the update stream, which contains both commands and new records to be 
inserted. The result of the processing is either a new master, sometimes called an 
updated source, or both the new master and a listing. 

COMMAND LANGUAGE 



The update process is controlled by commands which appear in the update stream. 
The format of the commands is presented in Figure 3-2. 

The elementary items within the square brackets may be optional. Spaces can be 
used freely to separate the elements, except that a blank must follow the single letter 
commands N and O. 

The SSUP commands consist of one or four letters. The commands and their 
functions are presented in Table 3-1. 

An F in the file/record indicator indicates that the command is to be applied to 
files rather than records. This mode is usually applicable to magnetic tape. When the 
file/record indicator is blank, the command is applied to a record. 

The limit arguments, which specify record or file numbers, are decimal integers 
not greater than 32,767. The meaning of these arguments is described in the examples 
which follow. Either or both of these arguments can be absent from all commands except 
NSRT, OMIT, BEGN, and COPY. These four commands require at least one argument. 
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SSUP-IOS 




SSUP 




Figure 3-1. SSUP Program Flow 



[Command] [F] [ Limit 1 ] [ , Limit 2 ] [-Comment] 



U 



'- Command /New Data Indicator 
$ = Command 
Other = New Data 



le/Record Indicator 
F = File 
Blank = Record 
1 



1 $0 is treated as a data card since it has a meaning to the FORTRAN compiler. 



Figure 3-2. SSUP Command Format 



An asterisk anywhere in the command causes the remainder of the line to be treated 
as a comment. Hence, the remainder of the line is ignored for processing, but it is listed 
if commands are being listed. 



A command which contains only a comment is acceptable. 
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Table 3-1. SSUP Commands 



. 

Command 


Function 


NSRT or N 


Insert new records. 


OMIT or O 


Omit old records or omit old records and insert 
new records. 


LIST 


List all records that come from old master plus 
all corrections that come from update source. 


NLST 


No records are listed. SSUP is initially in NLST 
mode. 


BEGN 


Position new master (used with magnetic tape only). 


COPY 


Copy old master on new master. 


NCPY 


Not generally useful: turns copy indicator off and 
nothing is written on new master. 


HALT 


Stop all I/O operations. Wait for operator action. 


RSET 


Reset input counters to record zero, file one 
(useful for concatenating old sources onto one new 
source) . 


WEOF 


Place end-of-file mark in new master. 


DONE 


Place end-of-file mark in new master and terminate 
SSUP process. 


DOLR 


Change command indicator (originally $) to next 
nonblank character. Useful for updating master 
files. 



SUMMARY EXAMPLE 

The example in Figure 3-3 is a typical update stream which uses the more common 
commands and functions. It is correct as shown for the old and new masters on magnetic 
tape and the update stream on cards. The flow is generally correct regardless of the 
media. 

In general, there are several combinations of commands and limits which will 
accomplish any task. The example presented in Figure 3-3, with reasonable extensions 
by the reader, is a straightforward approach which can accomplish all ordinary update 
tasks . 
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Operation 



Position Output 
Tape 



Position Input 
Tape 



Perform 
Update 



Command 



$BEGNF m 
$BEGN n 



Copy ' 
Remainder of 
Input Tape 

Terminate the 
Process' 



$OF, p 
$COPYF, q 



$ N r 



Functions 



Advance output (new master) 
tape past m- 1 file marks. 

Advance output tape past 
n-1 records. 



Skip files from current 
position to beyond file p. 

Copy from current posi- 
tion through and including 
file q. 



(new record) 

(new record) 
$ O t 



[(new record) 

(new record)] 
$ O u, v 



Copy old master from 
current position up to and 
including (r-l)th record. 
Insert following records 
until the next command is 
found. 



Copy old master from 
current position up to and 
including (t-l)th record. 
Insert following records, 
if any. 



[(new record 



(new record)] 



$COPYF, w 

$ WEOF 
$ DONE 



Copy old master from 
current position up to and 
including (u-l)th record. 
Skip records u through v. 
Insert following records, 
if any. 



Comments 



Tape is now in position to 
write n-th record on m-th 
file of output tape. 



New tape contains some 
number (between none and 
all) of files from old 
master. 



Copy old master from 
currert .jo^: f o- 'r^' "rr: 
v + 1) ii.r„u 6 .1 • ' ' 

Write end-of-file mark. 

Write end-of-file mark and 
indicate job is complete. 



'Two successive end-of-file marks (i.e. , a blank file) customarily indicate the end of 
data on a magnetic tape. 



Figure 3-3. SSUP Summary Example 
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LISTING 

Two types of listings, plus a no-listing option, can be obtained from SSUP. One 
listing is a transaction listing which is the default condition. All commands and comments 
are listed, along with the results of omit and insert actions. The records inserted are 
shown with a plus sign and the record number they acquired in the new master. The 
records omitted are shown with a minus sign and the record number they had in the old 
master. The transaction listing may be suppressed either by setting sense switch 4 or 
by including the LIST command. 

The LIST command overrides the transaction listing and causes the second type of 
listing to be generated. In this type, a line is output for every record read from the old 
master or the update stream. If there is no update, the resultant list is a source listing 
with the decimal record numbers printed on the left side. If no limits are stated, all 
records will be listed. If only j , limit 2 J is stated, all records from the current position 
through record "limit 2" will be listed. 

NSLT turns the LIST option off and restarts the transaction listing. 

Listings produced on the teletype are truncated after card image column 72. The 
tab format source is expanded to the conventional columns before being listed (i.e. , 
tabbed). 

MESSAGES 

There are two SSUP error messages, NONVALID COMMAND and LIMIT ERROR. 
An error message is followed by the current input (usually a command), the current file, 
and record counts. A reminder is also printed that informs the operator he may override 
the error or terminate the process. The override is accomplished by pushing START 
with sense switch 3 reset. The update stream will be ignored until the next command 
record is detected. If sense switch 3 is set, the effect is the same as a DONE command. 
These error messages are shown in the examples. 

There is one I/O error message possible if the old master is being read from 
magnetic tape. A nonrecoverable read error will cause the message PARITY ERROR and 
the file and record counts to be printed. Following the printout, the computer halts. If 
the A register is cleared, another read will be attempted when START is pushed. If the 
A register is not cleared, the record will be accepted as read. Sense switch 2 will sup- 
press the error message when it is set, but not the halt (with all bits set in the A register). 
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Unexpected end-of-file marks or end-of-tape being sensed will cause a halt without 
an error message. 

Other messages are BREAK POINT HALT and END OF JOB. The BREAK POINT 
HALT is output when a HALT command was encountered, presumably for the operator to 
change the input stream. 

RESEQUENCE OPTION (Keyword) 

If the output is magnetic tape, SSUP can resequence card image columns 77 through 
80 by either l's or 10's depending upon the keyword in the A register at the start. If 
resequencing is selected, the ID field (columns 73 through 76) is taken from the first 
record to be written on the new master. The A register keywords for the various options 
are: 

'000000 - Resequence by l's 

'100000 - Resequence by 10's 

'040000 - Copy input verbatim 

SENSE SWITCH OPTIONS 

The functions of the sense switches are presented in Table 3-2. 

Table 3-2. SSUP Functions of Sense Switches 



Switch 


Condition 


Function 


1 


Reset 
Set 


DAP- 16 format 
FORTRAN format 


2 


Reset 

Set 


Normal 

Suppress parity error 

message 


3 


Reset 

Set 


Continue process on error 

restart 

Terminate process on error 

restart 


4 


Reset 
Set 


Normal 

Suppress transaction listing 



SOURCE FORMAT 

If paper tape or the Teletype is used, the format must be either the correct tab 
form for the specific language or in acceptable columns. FORTRAN tab settings are at 
columns 6, 7, and 73. DAP- 16 tabs are at columns 6, 12, and 30. Lines are opened 
with a line feed and closed with a carriage return. 
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Magnetic tape must have 80-character records. 

OPERATION 

The operator must load an SSUP system configured for the desired devices, since 
SSUP cannot be configured at run time. If magnetic tape is to be used, the old master 
must be mounted on logical unit 1 and the new master on logical unit 2. This is consistent 
with the assembler and compiler assignments. 

The A register must be set with the keyword, and the computer started at location 
'1000. Successive jobs must have the keyword restored and started at location '1000. 

If the output is being punched on paper tape, the operator must manually punch 
leading and trailing blanks and turn off the punch at the end of the job. 

SYSTEM GENERATION 

An SSUP system must be generated for each combination of I/O devices desired. 

The allowed combinations and required device drivers are: 

Old Master - Magnetic Tape (logical unit 1) I$MA 

Paper Tape Reader I$PA 

New Master - Magnetic Tape (logical unit 2) 0$MA 

Paper Tape Punch 0$PA 

Update - Card Reader I$CA 

Teletype I$AA 

Paper Tape Reader I$PA 

Listing - Teletype 0$LL 

Line Printer 0$LA 

Messages - Teletype 0$LL 

The use of the Teletype as both the update master and the listing device is accept- 
able. The order of loading must not conflict with the above if the desired device streain 
attachments are to be made. 

If other combinations of I/O devices are desired it is possible to attach them by 
writing a driver which appears to SSUP-IOS as an allowable device. This is not supported 
by Honeywell. 

SSUP will operate in a 4K memory computer, but at least 8K is required to generate 
a system. 
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Load the ORGed SSUP and SSUP-IOS. Then select and Load (consistently with the 
previously noted order) the desired device driver and support programs for the four 
streams. If the Teletype I/O library which includes 0$LL was not loaded, do so at this 
point for the message output. Progress should be checked at this point by generating a 
memory map and observing that the correct calls are satisfied. Satisfy the remaining 
calls by loading SSUP-RDS, the associated dummy routine set. 

If magnetic tape is to be used, the type of I/O channel (DMA or DMC) and the 
channel number along with the logical-dialed number relationship must be entered. Refer 
to the Programmers' Reference Manual of the appropriate option for further instructions. 

EXAMPLE OF PAPER TAPE UPDATE 

The following file was punched with a Teletype to demonstrate the use of SSUP. It 
anticipates DAP format (i.e. , tab placement). All records start with a line feed and close 
with a carriage return. The use of an X-OFF and rubout is not required, since it will 
only be read by a paper tape reader. A nonprinting record following the printing text 
consists of a line feed, ETX, and carriage return. The ETX, which is punched by 
simultaneous CTRL and C keys, is recognized as an end-of-file. 

0R6\REC\0ME 

ORG\REC\TWO 

ORG\REC\THREE 

ORG\REC\FOUR 

ORG\REC\FIVE 

The first step in most source updates is to obtain a list of the file with record 
numbers. In this case a copy of the file after corrections that were made during the 
original punching is also obtained. Note that the Teletype shows an echo of the commands. 

$LIST 

SLIST 
SC0PYF1 

SCOPYFl 

00001 ORG REC ONE 

00002 ORG REC TWO 

00003 ORG REC THREE 

00004 ORG REC FOUR 

00005 ORG REC FIVE 
$D0NE 

SD0NE 

END OF JOB 
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The programmer decides that records 2 and 3 are to be replaced and a new record 
is to be inserted between records 4 and 5. He elects to list the transactions by leaving 
sense switch 4 reset. 

$ 0002,3 * FREE FORM - "0" AND "OMIT" ARE SYNONYMS 

S 0002,3 * FREE FORM - "0" AND "OMIT" ARE SYNONYMS 

-00002 ORG REC TWO 

-00003 ORG REC THREE 
NEW RECORD AAA 

+00002 NEW RECORD AAA 
SD0LR . * CHANGE COMMAND INDICATOR 

SDOLR . * CHANGE COMMAND INDICATOR 

.N 5 

.N 5 

$NEW RECORD BBB HAS A "$" AS THE FIRST CHARACTER 
+00004 $NEW RECORD BBB HAS A "$" AS THE FIRST CHARACTER 
.C0PYF1 

.COPYF! 

.DONE 

.DONE 

END OF JOB 

Since the new record starts with a control character, the command indicator in use 
was changed from a dollar sign to a period. 

As a final step the programmer listed the results. He chose not to copy the tape 
and because of this the listing shows each record as being deleted. In typing the com- 
mands, two errors were made to show the error messages. 
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SLIST 

SL1ST 
S0MIRF1 
NON-VALID COMMAND 
SOMIRF1 

FILE OOOOl .RECORD 00001 
SSW3 SET TO TERMINATE, RESET TO PROCESS NEXT COMMAND DEPRESS START. 
SON I TF 2,1 

$0MITF2,1 

LIMIT ERROR. 
$3MITF2,1 

FILE 00001 .RECORD 00001 
SSW3 SET TO TERMINATE, RESET TO PROCESS NEXT COMMAND DEPRESS START. 
SOMITFl 

S0MITF1 

-00001 ORG REC ONE 
-00002 NEW RECORD AAA 
-00003 ORG REC FOUR 

-00004 SNEW RECORD BBB HAS A "$" AS THE FIRST CHARACTER 
-00005 ORG REC FIVE 
SfJCPY 

SNCPY 

SDONE 

SO ONE 

END OF JOB 

EXAMPLE OF MAGNETIC TAPE UPDATE 

The first step to this example was to create three files by inserting records before 
the first record of a non-existent file. The cards used are shown as Figure 3-4. 

The programmer decided to update his source files by eliminating the first, chang- 
ing the second, and keeping the third intact. The original (or old master) remains 
intact. The new master contains entirely new data. 

Figures 3-5 and 3-6 are the transaction listing and a listing of the new master. 
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